PATHMac OS 8 and 9 Developer Documentation > Human Interface Toolbox > Appearance Manager >

Programming With the Appearance Manager

Theme Sound Constants

Your application can pass constants of type ThemeSoundKind to the function PlayThemeSound to play a theme-specific sound for an interface object when it changes state. Each sound plays asynchronously until complete, then stops automatically. The ThemeSoundKind constants are available with Appearance Manager 1.1 and later.

enum {
    kThemeSoundNone                     = 0,
    /* menu sounds */
    kThemeSoundMenuOpen                 = 'mnuo',
    kThemeSoundMenuClose                = 'mnuc',
    kThemeSoundMenuItemHilite           = 'mnui',
    kThemeSoundMenuItemRelease          = `mnus',
    /* window sounds */
    kThemeSoundWindowClosePress         = 'wclp',
    kThemeSoundWindowCloseEnter         = 'wcle',
    kThemeSoundWindowCloseExit          = 'wclx',
    kThemeSoundWindowCloseRelease       = 'wclr',
    kThemeSoundWindowZoomPress          = 'wzmp',
    kThemeSoundWindowZoomEnter          = 'wzme',
    kThemeSoundWindowZoomExit           = 'wzmx',
    kThemeSoundWindowZoomRelease        = 'wzmr',
    kThemeSoundWindowCollapsePress      = 'wcop',
    kThemeSoundWindowCollapseEnter      = 'wcoe',
    kThemeSoundWindowCollapseExit       = 'wcox',
    kThemeSoundWindowCollapseRelease    = 'wcor',
    kThemeSoundWindowDragBoundary       = 'wdbd',
    kThemeSoundUtilWinClosePress        = 'uclp',
    kThemeSoundUtilWinCloseEnter        = 'ucle',
    kThemeSoundUtilWinCloseExit         = 'uclx',
    kThemeSoundUtilWinCloseRelease      = 'uclr',
    kThemeSoundUtilWinZoomPress         = 'uzmp',
    kThemeSoundUtilWinZoomEnter         = 'uzme',
    kThemeSoundUtilWinZoomExit          = 'uzmx',
    kThemeSoundUtilWinZoomRelease       = 'uzmr',
    kThemeSoundUtilWinCollapsePress     = 'ucop',
    kThemeSoundUtilWinCollapseEnter     = 'ucoe',
    kThemeSoundUtilWinCollapseExit      = 'ucox',
    kThemeSoundUtilWinCollapseRelease   = 'ucor',
    kThemeSoundUtilWinDragBoundary      = 'udbd',
    kThemeSoundWindowOpen               = `wopn',
    kThemeSoundWindowClose              = 'wcls',
    kThemeSoundWindowZoomIn             = 'wzmi',
    kThemeSoundWindowZoomOut            = 'wzmo',
    kThemeSoundWindowCollapseUp         = 'wcol',
    kThemeSoundWindowCollapseDown       = 'wexp',
    kThemeSoundWindowActivate           = 'wact',
    kThemeSoundUtilWindowOpen           = `uopn',
    kThemeSoundUtilWindowClose          = 'ucls',
    kThemeSoundUtilWindowZoomIn         = 'uzmi',
    kThemeSoundUtilWindowZoomOut        = 'uzmo',
    kThemeSoundUtilWindowCollapseUp     = 'ucol',
    kThemeSoundUtilWindowCollapseDown   = 'uexp',
    kThemeSoundUtilWindowActivate       = 'uact',
    kThemeSoundDialogOpen               = `dopn',
    kThemeSoundDialogClose              = 'dlgc',
    kThemeSoundAlertOpen                = `aopn',
    kThemeSoundAlertClose               = 'altc',
    kThemeSoundPopopWindowOpen          = 'pwop',
    kThemeSoundPopupWindowClose         = 'pwcl',
    /* push button sounds */
    kThemeSoundButtonPress              = 'btnp',
    kThemeSoundButtonEnter              = 'btne',
    kThemeSoundButtonExit               = 'btnx',
    kThemeSoundButtonRelease            = 'btnr',
    kThemeSoundDefaultButtonPress       = 'dbtp',
    kThemeSoundDefaultButtonEnter       = 'dbte',
    kThemeSoundDefaultButtonExit        = 'dbtx',
    kThemeSoundDefaultButtonRelease     = 'dbtr',
    kThemeSoundCancelButtonPress        = 'cbtp',
    kThemeSoundCancelButtonEnter        = 'cbte',
    kThemeSoundCancelButtonExit         = 'cbtx',
    kThemeSoundCancelButtonRelease      = 'cbtr',
    /* checkbox sounds */
    kThemeSoundCheckboxPress            = 'chkp',
    kThemeSoundCheckboxEnter            = 'chke',
    kThemeSoundCheckboxExit             = 'chkx',
    kThemeSoundCheckboxRelease          = 'chkr',
    /* radio button sounds */
    kThemeSoundRadioPress               = 'radp',
    kThemeSoundRadioEnter               = 'rade',
    kThemeSoundRadioExit                = 'radx',
    kThemeSoundRadioRelease             = 'radr',
    /* scroll bar sounds */
    kThemeSoundScrollArrowPress         = 'sbap',
    kThemeSoundScrollArrowEnter         = 'sbae',
    kThemeSoundScrollArrowExit          = 'sbax',
    kThemeSoundScrollArrowRelease       = 'sbar',
    kThemeSoundScrollEndOfTrack         = 'sbte',
    kThemeSoundScrollTrackPress         = 'sbtp',
    /* slider sounds */
    kThemeSoundSliderEndOfTrack         = 'slte',
    kThemeSoundSliderTrackPress         = 'sltp',
    /* help balloon sounds */
    kThemeSoundBalloonOpen              = 'blno',
    kThemeSoundBalloonClose             = 'blnc',
    /* bevel button sounds */
    kThemeSoundBevelPress               = 'bevp',
    kThemeSoundBevelEnter               = 'beve',
    kThemeSoundBevelExit                = 'bevx',
    kThemeSoundBevelRelease             = 'bevr',
    /* increment/decrement button sounds */
    kThemeSoundLittleArrowUpPress       = 'laup',
    kThemeSoundLittleArrowDnPress       = 'ladp',
    kThemeSoundLittleArrowEnter         = 'lare',
    kThemeSoundLittleArrowExit          = 'larx',
    kThemeSoundLittleArrowUpRelease     = 'laur',
    kThemeSoundLittleArrowDnRelease     = 'ladr',
    /* pop-up button sounds */
    kThemeSoundPopupPress               = 'popp',
    kThemeSoundPopupEnter               = 'pope',
    kThemeSoundPopupExit                = 'popx',
    kThemeSoundPopupRelease             = 'popr',
    /* disclosure triangle sounds */
    kThemeSoundDisclosurePress          = 'dscp',
    kThemeSoundDisclosureEnter          = 'dsce',
    kThemeSoundDisclosureExit           = 'dscx',
    kThemeSoundDisclosureRelease        = 'dscr',
    /* tabs sounds */
    kThemeSoundTabPressed               = 'tabp',
    kThemeSoundTabEnter                 = 'tabe',
    kThemeSoundTabExit                  = 'tabx',
    kThemeSoundTabRelease               = 'tabr'
    /* Drag Manager sounds */
    kThemeSoundDragTargetHilite         = 'dthi',
    kThemeSoundDragTargetUnhilite       = 'dtuh',
    kThemeSoundDragTargetDrop           = 'dtdr',
    /* Finder sounds */
    kThemeSoundEmptyTrash               = 'ftrs',
    kThemeSoundSelectItem               = 'fsel',
    kThemeSoundNewItem                  = 'fnew',
    kThemeSoundReceiveDrop              = 'fdrp',
    kThemeSoundCopyDone                 = 'fcpd',
    kThemeSoundResolveAlias             = 'fral',
    kThemeSoundLaunchApp                = 'flap',
    kThemeSoundDiskInsert               = 'dski',
    kThemeSoundDiskEject                = 'dske',
    kThemeSoundFinderDragOnIcon         = 'fdon',
    kThemeSoundFinderDragOffIcon        = 'fdof'
};
typedef OSType ThemeSoundKind;

Constant descriptions

kThemeSoundNone
Specifies that no sound is played.
kThemeSoundMenuOpen
Identifies a sound to be played when the user opens a menu.
kThemeSoundMenuClose
Identifies a sound to be played when the user closes a menu.
kThemeSoundMenuItemHilite
Identifies a sound to be played when the user highlights a menu item.
kThemeSoundMenuItemRelease
Identifies a sound to be played when the user selects a menu item.
kThemeSoundWindowClosePress
Identifies a sound to be played when the user presses the mouse button while the cursor is over a window's close box.
kThemeSoundWindowCloseEnter
Identifies a sound to be played when the user moves the cursor over a window's close box after having moved the cursor away from the close box without releasing the mouse button.
kThemeSoundWindowCloseExit
Identifies a sound to be played when the user moves the cursor away from a position over a window's close box, while the mouse button remains pressed.
kThemeSoundWindowCloseRelease
Identifies a sound to be played when the user releases the mouse button while the cursor is over a window's close box.
kThemeSoundWindowZoomPress
Identifies a sound to be played when the user presses the mouse button while the cursor is over a window's zoom box.
kThemeSoundWindowZoomEnter
Identifies a sound to be played when the user moves the cursor over a window's zoom box after having moved the cursor away from the zoom box without releasing the mouse button.
kThemeSoundWindowZoomExit
Identifies a sound to be played when the user moves the cursor away from a position over a window's zoom box, while the mouse button remains pressed.
kThemeSoundWindowZoomRelease
Identifies a sound to be played when the user releases the mouse button while the cursor is over a window's zoom box.
kThemeSoundWindowCollapsePress
Identifies a sound to be played when the user presses the mouse button while the cursor is over a window's collapse box.
kThemeSoundWindowCollapseEnter
Identifies a sound to be played when the user moves the cursor over a window's collapse box after having moved the cursor away from the collapse box without releasing the mouse button.
kThemeSoundWindowCollapseExit
Identifies a sound to be played when the user moves the cursor away from a position over a window's collapse box, while the mouse button remains pressed.
kThemeSoundWindowCollapseRelease
Identifies a sound to be played when the user releases the mouse button while the cursor is over a window's collapse box.
kThemeSoundWindowDragBoundary
Identifies a sound to be played when the user drags a window to the edge of the area where it can be dragged. Note: This functionality is not available under Appearance Manager 1.1 or prior versions of Appearance.
kThemeSoundUtilWinClosePress
Identifies a sound to be played when the user presses the mouse button while the cursor is over a utility (floating) window's close box.
kThemeSoundUtilWinCloseEnter
Identifies a sound to be played when the user moves the cursor over a utility (floating) window's close box after having moved the cursor away from the close box without releasing the mouse button.
kThemeSoundUtilWinCloseExit
Identifies a sound to be played when the user moves the cursor away from a position over a utility (floating) window's close box, while the mouse button remains pressed.
kThemeSoundUtilWinCloseRelease
Identifies a sound to be played when the user releases the mouse button while the cursor is over a utility (floating) window's close box.
kThemeSoundUtilWinZoomPress
Identifies a sound to be played when the user presses the mouse button while the cursor is over a utility (floating) window's zoom box.
kThemeSoundUtilWinZoomEnter
Identifies a sound to be played when the user moves the cursor over a utility (floating) window's zoom box after having moved the cursor away from the zoom box without releasing the mouse button.
kThemeSoundUtilWinZoomExit
Identifies a sound to be played when the user moves the cursor away from a position over a utility (floating) window's zoom box, while the mouse button remains pressed.
kThemeSoundUtilWinZoomRelease
Identifies a sound to be played when the user releases the mouse button while the cursor is over a utility (floating) window's zoom box.
kThemeSoundUtilWinCollapsePress
Identifies a sound to be played when the user presses the mouse button while the cursor is over a utility (floating) window's collapse box.
kThemeSoundUtilWinCollapseEnter
Identifies a sound to be played when the user moves the cursor over a utility (floating) window's collapse box after having moved the cursor away from the collapse box without releasing the mouse button.
kThemeSoundUtilWinCollapseExit
Identifies a sound to be played when the user moves the cursor away from a position over a utility (floating) window's collapse box, while the mouse button remains pressed.
kThemeSoundUtilWinCollapseRelease
Identifies a sound to be played when the user releases the mouse button while the cursor is over a utility (floating) window's collapse box.
kThemeSoundUtilWinDragBoundary
Identifies a sound to be played when the user drags a utility (floating) window to the edge of the area where it can be dragged. Note: This functionality is not available under Appearance Manager 1.1 or prior versions of Appearance.
kThemeSoundWindowOpen
Identifies a sound to be played when the user opens a window.
kThemeSoundWindowClose
Identifies a sound to be played when the user closes a window.
kThemeSoundWindowZoomIn
Identifies a sound to be played when the user zooms a window in, that is, to the user state.
kThemeSoundWindowZoomOut
Identifies a sound to be played when the user zooms a window out, that is, to the standard state.
kThemeSoundWindowCollapseUp
Identifies a sound to be played when the user collapses a window.
kThemeSoundWindowCollapseDown
Identifies a sound to be played when the user uncollapses a window.
kThemeSoundWindowActivate
Identifies a sound to be played when the user presses the mouse button while the cursor is over an inactive window, thus activating it.
kThemeSoundUtilWindowOpen
Identifies a sound to be played when the user opens a utility (floating) window.
kThemeSoundUtilWindowClose
Identifies a sound to be played when the user closes a utility (floating) window.
kThemeSoundUtilWindowZoomIn
Identifies a sound to be played when the user zooms a utility (floating) window in, that is, to the user state.
kThemeSoundUtilWindowZoomOut
Identifies a sound to be played when the user zooms a utility (floating) window out, that is, to the standard state.
kThemeSoundUtilWindowCollapseUp
Identifies a sound to be played when the user collapses a utility (floating) window.
kThemeSoundUtilWindowCollapseDown
Identifies a sound to be played when the user uncollapses a utility (floating) window.
kThemeSoundUtilWindowActivate
Identifies a sound to be played when the user presses the mouse button while the cursor is over an inactive utility (floating) window, thus activating it.
kThemeSoundDialogOpen
Identifies a sound to be played when a dialog box opens.
kThemeSoundDialogClose
Identifies a sound to be played when a dialog box closes.
kThemeSoundAlertOpen
Identifies a sound to be played when an alert box opens.
kThemeSoundAlertClose
Identifies a sound to be played when an alert box closes.
kThemeSoundPopopWindowOpen
Identifies a sound to be played when a pop-up window opens.
kThemeSoundPopupWindowClose
Identifies a sound to be played when a pop-up window closes.
kThemeSoundButtonPress
Identifies a sound to be played when the user presses the mouse button while the cursor is over a push button.
kThemeSoundButtonEnter
Identifies a sound to be played when the user moves the cursor over a push button after having moved the cursor away from the button without releasing the mouse button.
kThemeSoundButtonExit
Identifies a sound to be played when the user moves the cursor away from a position over a push button, while the mouse button remains pressed.
kThemeSoundButtonRelease
Identifies a sound to be played when the user releases the mouse button while the cursor is over a push button.
kThemeSoundDefaultButtonPress
Identifies a sound to be played when the user presses the mouse button while the cursor is over a default button.
kThemeSoundDefaultButtonEnter
Identifies a sound to be played when the user moves the cursor over a default button after having moved the cursor away from the button without releasing the mouse button.
kThemeSoundDefaultButtonExit
Identifies a sound to be played when the user moves the cursor away from a position over a default button, while the mouse button remains pressed.
kThemeSoundDefaultButtonRelease
Identifies a sound to be played when the user releases the mouse button while the cursor is over a default button.
kThemeSoundCancelButtonPress
Identifies a sound to be played when the user presses the mouse button while the cursor is over a Cancel button.
kThemeSoundCancelButtonEnter
Identifies a sound to be played when the user moves the cursor over a Cancel button after having moved the cursor away from the button without releasing the mouse button.
kThemeSoundCancelButtonExit
Identifies a sound to be played when the user moves the cursor away from a position over a Cancel button, while the mouse button remains pressed.
kThemeSoundCancelButtonRelease
Identifies a sound to be played when the user releases the mouse button while the cursor is over a Cancel button.
kThemeSoundCheckboxPress
Identifies a sound to be played when the user presses the mouse button while the cursor is over a checkbox.
kThemeSoundCheckboxEnter
Identifies a sound to be played when the user moves the cursor over a checkbox after having moved the cursor away from the checkbox without releasing the mouse button.
kThemeSoundCheckboxExit
Identifies a sound to be played when the user moves the cursor away from a position over a checkbox, while the mouse button remains pressed.
kThemeSoundCheckboxRelease
Identifies a sound to be played when the user releases the mouse button while the cursor is over a checkbox.
kThemeSoundRadioPress
Identifies a sound to be played when the user presses the mouse button while the cursor is over a radio button.
kThemeSoundRadioEnter
Identifies a sound to be played when the user moves the cursor over a radio button after having moved the cursor away from the radio button without releasing the mouse button.
kThemeSoundRadioExit
Identifies a sound to be played when the user moves the cursor away from a position over a radio button, while the mouse button remains pressed.
kThemeSoundRadioRelease
Identifies a sound to be played when the user releases the mouse button while the cursor is over a radio button.
kThemeSoundScrollArrowPress
Identifies a sound to be played when the user presses the mouse button while the cursor is over a scroll bar arrow.
kThemeSoundScrollArrowEnter
Identifies a sound to be played when the user moves the cursor over a scroll bar arrow after having moved the cursor away from the arrow without releasing the mouse button.
kThemeSoundScrollArrowExit
Identifies a sound to be played when the user moves the cursor away from a position over a scroll bar arrow, while the mouse button remains pressed.
kThemeSoundScrollArrowRelease
Identifies a sound to be played when the user releases the mouse button while the cursor is over a scroll bar arrow.
kThemeSoundScrollEndOfTrack
Identifies a sound to be played when a scroll box arrives at the end of a scroll bar and can go no further. Note: This functionality is not available under Appearance Manager 1.1 or prior versions of Appearance.
kThemeSoundScrollTrackPress
Identifies a sound to be played when the user presses the mouse button while the cursor is over the track part of a scroll bar (this area does not include the scroll box or scroll bar arrows).
kThemeSoundSliderEndOfTrack
Identifies a sound to be played when a slider indicator arrives at the end of a slider track and can go no further. Note: This functionality is not available under Appearance Manager 1.1 or prior versions of Appearance.
kThemeSoundSliderTrackPress
Identifies a sound to be played when the user presses the mouse button while the cursor is over the track part of a slider (this area does not include the slider indicator).
kThemeSoundBalloonOpen
Identifies a sound to be played when a help balloon appears.
kThemeSoundBalloonClose
Identifies a sound to be played when a help balloon disappears.
kThemeSoundBevelPress
Identifies a sound to be played when the user presses the mouse button while the cursor is over a bevel button.
kThemeSoundBevelEnter
Identifies a sound to be played when the user moves the cursor over a bevel button after having moved the cursor away from the bevel button without releasing the mouse button.
kThemeSoundBevelExit
Identifies a sound to be played when the user moves the cursor away from a position over a bevel button, while the mouse button remains pressed.
kThemeSoundBevelRelease
Identifies a sound to be played when the user releases the mouse button while the cursor is over a bevel button.
kThemeSoundLittleArrowUpPress
Identifies a sound to be played when the user presses the mouse button while the cursor is over the upward-pointing arrow of an increment/decrement button.
kThemeSoundLittleArrowDnPress
Identifies a sound to be played when the user presses the mouse button while the cursor is over the downward-pointing arrow of an increment/decrement button.
kThemeSoundLittleArrowEnter
Identifies a sound to be played when the user moves the cursor over an increment/decrement button after having moved the cursor away from the button without releasing the mouse button.
kThemeSoundLittleArrowExit
Identifies a sound to be played when the user moves the cursor away from a position over an increment/decrement button, while the mouse button remains pressed.
kThemeSoundLittleArrowUpRelease
Identifies a sound to be played when the user releases the mouse button while the cursor is over the upward-pointing arrow of an increment/decrement button.
kThemeSoundLittleArrowDnRelease
Identifies a sound to be played when the user releases the mouse button while the cursor is over the downward-pointing arrow of an increment/decrement button.
kThemeSoundPopupPress
Identifies a sound to be played when the user presses the mouse button while the cursor is over a pop-up menu button.
kThemeSoundPopupEnter
Identifies a sound to be played when the user moves the cursor over a pop-up menu button after having moved the cursor away from the button without releasing the mouse button.
kThemeSoundPopupExit
Identifies a sound to be played when the user moves the cursor away from a position over a pop-up menu button, while the mouse button remains pressed.
kThemeSoundPopupRelease
Identifies a sound to be played when the user releases the mouse button while the cursor is over a pop-up menu button.
kThemeSoundDisclosurePress
Identifies a sound to be played when the user presses the mouse button while the cursor is over a disclosure triangle.
kThemeSoundDisclosureEnter
Identifies a sound to be played when the user moves the cursor over a disclosure triangle after having moved the cursor away from the disclosure triangle without releasing the mouse button.
kThemeSoundDisclosureExit
Identifies a sound to be played when the user moves the cursor away from a position over a disclosure triangle, while the mouse button remains pressed.
kThemeSoundDisclosureRelease
Identifies a sound to be played when the user releases the mouse button while the cursor is over a disclosure triangle.
kThemeSoundTabPressed
Identifies a sound to be played when the user presses the mouse button while the cursor is over a tab.
kThemeSoundTabEnter
Identifies a sound to be played when the user places the cursor over a tab.
kThemeSoundTabExit
Identifies a sound to be played when the user moves the cursor over a tab after having moved the cursor away from the tab without releasing the mouse button.
kThemeSoundTabRelease
Identifies a sound to be played when the user releases the mouse button while the cursor is over a tab.
kThemeSoundDragTargetHilite
Identifies a sound to be played when the user drags an object over a valid drag-and-drop destination.
kThemeSoundDragTargetUnhilite
Identifies a sound to be played when the user drags an object away from a valid drag-and-drop destination.
kThemeSoundDragTargetDrop
Identifies a sound to be played when the user drops an object on a valid drag-and-drop destination.
kThemeSoundEmptyTrash
Identifies a sound to be played when the Finder completes emptying the Trash directory.
kThemeSoundSelectItem
Identifies a sound to be played when the user presses the mouse button while the cursor is over an item in the Finder.
kThemeSoundNewItem
Identifies a sound to be played when the user creates a new item.
kThemeSoundReceiveDrop
Identifies a sound to be played when a Finder object changes parents, such as when the user drops an icon on a folder.
kThemeSoundCopyDone
Identifies a sound to be played when the Finder completes a copy operation.
kThemeSoundResolveAlias
Identifies a sound to be played when the Finder resolves an alias.
kThemeSoundLaunchApp
Identifies a sound to be played when the Finder launches an application.
kThemeSoundDiskInsert
Identifies a sound to be played when a disk is inserted.
kThemeSoundDiskEject
Identifies a sound to be played when a disk is ejected.
kThemeSoundFinderDragOnIcon
Identifies a sound to be played when the user drags an object over an icon.
kThemeSoundFinderDragOffIcon
Identifies a sound to be played when the user drags an object off of an icon.
© 1999 Apple Computer, Inc. – (Last Updated 29 April 99)